Rename Folder
AutomatR.Dropbox.Activities.RenameFolder
The "Rename Folder" activity in AutomatR is part of the Dropbox activities package, designed to rename a folder within the user's Dropbox account. This activity streamlines the process of renaming folders in Dropbox, enhancing the efficiency of automation workflows.
Properties
| Name | Description |
|---|---|
| Input | |
| Folder Path | Specifies the full path of the folder to be renamed in Dropbox. String variables containing the folder path. Example: "Root/FolderRename" |
| New Name | Specifies the new folder name. String variables containing the new folder name. |
| Misc | |
| Display Name | Provides a customizable name for the activity displayed in the workflow. The display name enhances clarity and organization within the automation project. String variables containing the desired display name. |
| Optional | |
| Delay | Specifies the amount of time (in seconds) to wait before executing the "Rename Folder" activity. Integer variables containing the delay duration. Example: 5 seconds i.e. 5. |
| Output | |
| Result | Outputs a boolean value indicating whether the folder rename operation was successful (True) or encountered errors (False). Variables of relevant types (e.g., Boolean variables) to store the operation result. |
How to Use
- Drag and drop the "Rename Folder" activity onto the workflow.
- Configure the properties by specifying the folder path to be renamed, the new folder name, and optionally set the delay and customize the display name.
- Execute the workflow to rename the specified folder within Dropbox.
Important Notes:
- Ensure that the activity is placed within a "Dropbox Scope" activity to establish the necessary authentication scope.
- The "Folder Path" should include the full path of the folder to be renamed in Dropbox.
- If the "New Name" includes a path separator (e.g., "\" or "/"), it will be treated as a nested folder structure within the original path.
- Verify that the provided folder path exists and refers to a folder; otherwise, an exception will be raised.
- The activity checks for existing folders with the new name and raises an exception if a conflict is detected.
Example:
Consider an example where the "Rename Folder" activity is used to rename a folder named "FolderRename" to "RenamedFolder" within Dropbox:
Rename Folder:
Display Name: "Rename Document"
Folder Path: "Root/FolderRename"
New Name: "RenamedFolder"
Result: isRenameSuccessful
In this example, the activity renames the folder "FolderRename" to "RenamedFolder" within the specified path in Dropbox. The result of the operation (success or failure) is stored in the Boolean variable "isRenameSuccessful" for further handling in the workflow.